home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 January - Disc 2 / Macworld (1999-01) (Disk 2).dmg / Shareware World / Info / For Developers / mercutioPPC / ReadMe < prev    next >
Text File  |  1998-11-01  |  9KB  |  166 lines

  1. Mercutio Patcher 2.5.1  ReadMe document  981101
  2. by Ola Ekedahl <ekedahl@telia.com>
  3. http://w1.317.telia.com/~u31705058/dev
  4.  
  5. Is Mercutio Patcher not free anymore? Why, and how do I pay?
  6. Yes, thats correct, Mercutio Patcher is now shareware.
  7. Many of you may think, "why did he make it shareware now?!". Its because I need 
  8. money to keep on developing Mercutio Patcher and other programs. The fee isnt 
  9. high, 15$. Please support my software!
  10. You can pay by printing the form thats included with Mercutio Patcher ("Order Form", 
  11. if you dont have a printer, write your own order form similar to that included) and mail
  12. it to me with your payment.
  13. When I have recieved the order with the payment, I will send you the serial number in
  14. an email or with the diskette (mail) if you specify it on the order form(+4.95$).
  15.  
  16. Why doesnt Mercutio Patcher allow me to patch applications?
  17. Until you have registered Mercutio Patcher, you can only scan or check applications
  18. not patch them.
  19. When you have registered Mercutio Patcher you will be able to patch.
  20.  
  21. How do I install the Mercutio Patcher?
  22. Its very easy! You don't need to install anything. The only thing you need
  23. is, of course, the Mercutio Patcher. Just double click upon the Mercutio
  24. Patcher and off you go!
  25.  
  26. What do I do when I have launched Mercutio Patcher?
  27. If you want to, you are now able to search entire folders for applications
  28. that use Mercutio MDEF. Push the button 'Scan folder...' and select a folder.
  29. (Scaning of harddrives now supported)
  30. After a while (the time it takes depends on how many files there are in the folder, 
  31. aprox. 1 min for 250 applications) it will pop up some names in a list in the main window.
  32. You can now either select on of the applications shown and patch that 
  33. singel on by pushing the button 'Patch Selected' or patch all the applications
  34. in the list by pushing the button 'Patch All'.
  35.  
  36. You can also check and patch only on application. Push the button 'Check & Patch'
  37. at the bottom of the window. Now, select the application you want to check and click open.
  38. Mercutio Patcher will now check if the application needs to be patched.
  39. If it does need to be patched, a new window will pop up and you have
  40.  to select if you want to patch or not.
  41.  
  42. ***NOTE  Older beta versions of the Mercutio Patcher 2.0 (2.0b6 and
  43. earlier) had a ResEdit file with them. That file is no longer needed with
  44. Mercutio Patcher 2.0b13 and later. The only thing you need is the
  45. application Mercutio Patcher 2.0.
  46.  
  47. What is the Mercutio MDEF?
  48. To make it simple, the Mercutio MDEF is a resource inside an application
  49. program that draws the menus of that application. 
  50.  
  51. Why do I need to patch my applications?
  52. First, not all applications use Mercutio MDEF. Only some of them (read included readme 
  53. document 'Mercutio Apps').
  54. The reason why you need to patch some applications is that they use an old
  55. version of Mercutio MDEF. That old version can make some applications
  56. crash or behave strange under MacOS 8.x. (ugly menu colors or pop-up menu
  57. glitches)
  58.  
  59. How do Mercutio Patcher work?
  60. Mercutio Patcher use a new version of Mercutio MDEF (v.1.5.2) and simply
  61. replaces the old one in an application with the new one. 
  62. Before replacing the resources, Mercutio Patcher makes a copy of the
  63. application you have chosen, so that if the patch did not work, you still
  64. have the old version left. This copy is placed in a folder called '[appname]- unpatched'.
  65.  
  66. It is also important that you know that if there in the future comes an
  67. upgrade for your application, it may not work with the version you have
  68. patched with Mercutio Patcher. That is because some updater programs check
  69. to see if you have made any changes in your application. So, to be on the
  70. safe side, save the unpatched copy of your program! You may find it more
  71. convenient to keep the unpatched copy in some form of archive format (such
  72. as .sit, .sea, .img, or .smi), so when you double-click upon a file whose
  73. creator is that the program then the patched version will launch.
  74. Otherwise, if both variants of your application are on mounted volume(s)
  75. it will be a matter of chance as to which is launched.
  76.  
  77. How do I know which applications to patch?
  78. There is no good way other then if the application won't work under MacOS
  79. 8.x OR instead to use the Mercutio Patcher and click the button 'Check & Patch'. 
  80. Then Mercutio Patcher will check the application you have
  81. chosen to see if it needs to be patched.
  82. A list of applications that use Mercutio MDEF is included ('Mercutio Apps').
  83. It contains 99 applications, but there can be more of them out there.
  84. Please help me and others by sending in lists of other applications that
  85. can be patched! (ola.ekedahl@goteborg.mail.telia.com)
  86.  
  87. How do I know that its the right application I am patching?
  88. If you know that you have more versions of the same program, and all of the 
  89. programs were added in the list after a scan, then just double click on one 
  90. of the applications in the list and Mercutio Patcher will show you the 
  91. full path to the application.
  92.  
  93. I can not find the copy of my program Mercutio Patcher should have made?
  94. You can find the copy Mercutio Patcher made in the folder '[appname]-Unpatched' in
  95. the same folder as your application i.e in the application you have
  96. patched. If you are unsure, read the logfile in same folder as Mercutio Patcher. In that file you will find the path to the unpatched version and the patched version.
  97.  
  98. What is the system requirements?
  99. For PPC:
  100. A minimum of 2MB free memory
  101. Any PPC processor
  102.  
  103. For 68k:
  104. A minimum of 1.5MB free memory
  105.  
  106. Not much of a system require list. The 68k version has been reported to work on a Macintoh Plus (system unknow).
  107.  
  108. Version history
  109. The only beta versions released to the public has been: 2.0b6 and 2.0b13.
  110. There has also been many small bugfixes in every version that I havent written here (below).
  111.  
  112. 2.5.1             - Changes was made with the serial codes after serious bug found.
  113.                                                     - Minor bugfixes and user interface changes.
  114.                                                     - Both Dutch and German versions of Mercutio Patcher 2.5.1 is now downloadable.
  115. 2.5                   - Mercutio Patcher is no longer freeware. The fee is set to 15$ (US)
  116.                                                     Fixed a bug that could cause Mercutio Patcher not to make a copy, or put it in the wrong folder.
  117.                 Added version number of the current MDEF when you scan folders/drives.
  118.                                                                 Added version number of the current MDEF when you select "Check & Patch".
  119. 2.1.1    - Double click in the list and MP will show you the path to the application.
  120.                 Logfile added so it is easier to find unpatched applications and patched applications.
  121.                 First German version.
  122.                                                                 Minor bugfixes.
  123. 2.1                             - Fixed problems that made scaning harddrives impossible.
  124.                                                        Mercutio Patcher no longer resoloves alias.
  125.                                                                 Better errormessages.
  126.                                                                 Minor bugfixes.
  127. 2.0                             - Final release!! Minor bug fixes. 
  128. 2.0b24 - Progressbar is now invisible when it's not in use. To make it simple to
  129.                                                                 know when Mercutio Patche is idle.
  130. 2.0b23 - Minor bug fixes.
  131. 2.0b22 - A serious bug was fixed.
  132.                                                                 Made it impossible to select other then applications in the 'Check & Patch'
  133. 2.0b21 - Some error messages didnt show properly.
  134. 2.0b20 - Fixed some bugs that made a resize of the window impossible. May not work on 68k.
  135.                                                                 Complaints about user interface problems on b&w macs made me change
  136.                                                                 the background color to gray (default). Maybe it will work better now?
  137. 2.0b19 - Window is now resizable
  138. 2.0b18 - 'Patch All' button now works
  139. 2.0b17 - First released (closed) beta with working 'scan folders'  feature
  140.                                                                 It was also possible to patch by clicking 'Patch Selected'
  141. 2.0b16 - Big parts of the code was rewritten to make it smaller and faster
  142. 2.0b15 - Second test with scan folders feature.
  143. 2.0b14 - First test with scan folders feature.
  144. 2.0b13 - The resource file is now built in to the program wich renders the file 'Mercutio MDEF 1.5.2'
  145.                                                                     usless
  146.                                                                  Some of the code had to be rewritte too.
  147. Version history has been lost for later versions.
  148.  
  149. Disclaimer & Copyright
  150. I can not be held responsible for any damage or problems you might
  151. encounter while using this program or after having used this program. You
  152. use Mercutio Patcher entirely at your own risk. 
  153.  
  154. I am in no way affiliated with Mercutio or its development; and please do
  155. not contact Ramon about this program, as he had nothing to do with it, nor
  156. does he know anything about it at all !!!
  157.  
  158. The code for this program is not free! 
  159. Mercutio Patcher is shareware. The fee for Mercutio Patcher is 15$ (US).
  160. Mercutio Patcher can be distributed on any CD's, inluding CD's that that 
  161. isnt free, i.e. CD's included with magazines, other commercial programs et c.
  162. Mercutio MDEF is also totally free and can be found at
  163. http://www.digitalalchemy/mercutio
  164.  
  165. Mercutio Patcher (C)Copyright 1998 Ola Ekedahl, All Rights Reserved
  166. Mercutio MDEF (C)Copyright 1992-1998 Ramon Felciano